home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / lan / lpdnlm25.zip / MANUAL.TXT < prev    next >
Text File  |  1996-05-12  |  19KB  |  524 lines
  1.  
  2.  
  3.  
  4.     
  5.                 iQueue
  6.  
  7.         LPD/LPR printing connectivity for 
  8.         Novell NetWare 3.1x & 4.x
  9.                 
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. May 1996
  60.  
  61. The information in this document is subject to change without notice and should not be construed as a commitment by Smart Systems. Smart Systems assumes 
  62. no responsibility for any errors that may appear in this document.
  63.  
  64. DEC, VMS, DECnet are registered trademarks of Digital Equipment Corporation.
  65. UNIX is a registered trademark of AT&T.
  66. MS-DOS is a registered trademark of Microsoft Corporation.
  67. NetWare and Novell  are registered trademarks of Novell Inc.
  68.  
  69. All other brand and product names are trademarks or registered trademarks of their respective companies.
  70.  
  71.  
  72.  
  73. Copyright c1992-1996 SMART SYSTEMS.
  74.  
  75.  
  76.  
  77. Contents
  78.  
  79. 1.1 Introduction    2
  80. 1.2 Prerequisites    2
  81. 2.0 UNIX-to-NetWare Printing    3
  82. 2.1 Installing the NetWare NLM    3
  83. 2.2 Configuring Queues for LPD    4
  84. 2.3 LPR Options    6
  85. 2.4 Remote Host Configuration    6
  86. 2.5 Privileged Hosts    6
  87. 2.6 Queue Job Ownership    7
  88. 2.7 LPQ and LPRM Commands    7
  89. 3.0 NetWare-to-UNIX Printing    8
  90. 3.1 Installing the NetWare NLM    8
  91. 3.2 Print Queue Configuration    8
  92. 3.3 Queue Types    8
  93. 3.4 LPR Transfer Notification    9
  94. 3.5 Printcap File    9
  95. 4.1 Troubleshooting    10
  96. Appendix A - LPD control code interpretation    11
  97. Appendix B - UNIX Printcap Entries    12
  98.  
  99.  
  100.  
  101.  
  102.  
  103. 1.1 Introduction
  104.  
  105.     iQueue provides a pair of NetWare Loadable Modules (NLM) which implement the Berkeley Line Printer Daemon 
  106. (RFC1179, LPD) protocol. This is the de facto standard remote printing protocol for UNIX. The LPD protocol that 
  107. layers on top of TCP/IP is also supported by many other operating systems.
  108.  
  109.     The LPD NLM allows a NetWare file server to accept print jobs from systems supporting the LPD protocol. 
  110. NetWare queue inquiry and job deletion are supported by the UNIX LPQ and LPRM commands. The LPR NLM 
  111. allows a NetWare file server to service local NetWare print-queues for transmission via the LPD protocol to remote 
  112. hosts.
  113.     
  114.     If you have not been supplied with authorisation keys this software will run in demonstration mode (except for un-
  115. keyed versions of the software). The implication of this is that the NLMs will terminate and unload after one hour. 
  116. Please see the file order.inf for further information. 
  117.  
  118.     The configuration of the UNIX (or other) host is not addressed here. You will need to consult with the system 
  119. administrator responsible for the remote host.
  120.  
  121. 1.2 Prerequisites
  122.  
  123.     Ensure the TCPIP.NLM is loaded and configured correctly on your NetWare server. Refer to the TCP/IP Transport 
  124. Supervisors Guide included with your NetWare documentation set, or the Novell technical note NetWare TCP/IP 
  125. Installation and Configuration on a NetWare 3.11 Fileserver available as NWTCP.TXT from any Novell FTP 
  126. mirror in NOVLIB 8.
  127.     
  128.     It is strongly recomended that TCPIP.NLM be version 2.02m or later, this is found on a NetWare archive as 
  129. TCP188.EXE.
  130.  
  131.     If you are running NetWare 3.11 you may not have the required support NLM NWSNUT, without this 
  132. LPDSET.NLM will report missing symbols. NWSNUT can be obtained as part of the Novell update LIBUP3.EXE. 
  133. This file can be obtained from ftp.novell.com or Netwire on CompuServe.
  134.     
  135.     Enter the names and addresses of the remote TCP/IP hosts that you wish to print to and from into the sys:\etc\hosts 
  136. file on the NetWare server.
  137.  
  138.     Check that the TCP/IP connection is working by PINGing the NetWare server from the remote host.
  139.  
  140.     NetWare 4.xx environments require that Bindery Emulation is enabled.
  141.  
  142.  
  143.  
  144. 2.0 UNIX-to-NetWare Printing
  145. 2.1 Installing the NetWare NLM
  146.  
  147.     Copy the LPD.NLM, LPD.PS and LPDSET.NLM from the distribution directory to the sys:\system directory on 
  148. your target server.
  149.  
  150.     On the File Server Console type
  151.         load LPD <auth_key> [verbose] [text] [threads=x] [user=userid]
  152.     This will load and start the LPD server software,  presenting the status screen. To switch between console screens 
  153. type Ctrl-ESC.
  154.     The command line options for LPD are:
  155.     auth_key    The required server specific authorisation key. Note site licence versions of the software will not 
  156. require a key.
  157.     verbose    The status screen will display debugging information.
  158.     text    All the inward queues are text queues and will have the CR to CR/LF filter applied.
  159.     threads=    Allows performance tuning by increasing or decreasing the number of LPD server threads, this 
  160. could be reduced on small servers to lower memory overhead or increased in high volume 
  161. environments. Idle threads use no CPU resource. The range is 1 through 10 with the default 
  162. being 5.
  163.     user=    Specifies a userid that all incoming print jobs will belong to. This userid may have a password 
  164. but not an expiry date or login count restrictions. Use this option only if you have problems with 
  165. print servers servicing jobs spooled by iQueue.
  166.  
  167.     To ensure that the printer daemon NLM is loaded each time your file server starts, edit with a text editor or the 
  168. INSTALL NLM  sys:\system\autoexec.ncf , adding the load command to the end of script.
  169.         e.g. load LPD abb543e text threads=3
  170.  
  171.  
  172.  
  173.  
  174. 2.2 Configuring Queues for LPD
  175.  
  176.     Once the LPD NLM is loaded all print queues on the NetWare server are available to receive LPD print jobs.
  177.  
  178.     Configuration of individual queue options is done with the LPDSET.NLM, at the console prompt enter load 
  179. LPDSET.
  180.  
  181.     Select the queue to configure by pressing enter, the screen shown below is displayed.
  182.  
  183.      
  184.  
  185.     Secure:
  186.     By default (No) any remote user may print to a NetWare queue via the LPD NLM. 
  187.     Setting a queue to secure causes the NLM to attempt a match between the remote userid and a local NetWare 
  188. user. If the match or NetWare security fails the job is discarded. Secure queues require that the NetWare user 
  189. has a valid account (e.g. not disabled or expired) and is a user of the queue as defined in PCONSOLE.
  190.     Care must be taken when limiting concurrent NetWare logins for users as a count against this restriction is 
  191. used when a print job is being received. This option is useful in environments where printer accounting is 
  192. used.
  193.  
  194.     Filter:
  195.     Converts the incoming data, the currently available filters are:
  196.     Binary    Passes data without change (default).
  197.     Text    Converts CR to CR/LF characters. 
  198.     Fortran    Converts print jobs with fortran carriage control characters into formatted form.
  199.     Text -> Postscript    
  200.     Converts plain text files into the Postscript printer language. If the inward job is already in 
  201. Postscript form no conversion is performed. Different character mapping (for Scandinavian 
  202. countries) can be configured  by editing the file LPD.PS with a text editor.
  203.     When the `text' option is used with the LPD load command the filter is Text for every queue 
  204. regardless of this setting.
  205.     
  206.     Configure Filter:
  207.         This option is only available for the Postscript filter. Selection presents a form for setting paper size, margins 
  208. and font. Measurements are in points, 72 points = 1 inch, 28.35 points = 1 cm.
  209.  
  210.     Suppress Banner:    
  211. Disables the printer banner page for all inward jobs on this queue. Banners should be suppressed for Postscript 
  212. print queues unless the NetWare print server is "Postscript aware" (e.g. ATPS).
  213.  
  214.  
  215.  
  216.     Suppress Form Feed:
  217.         Sets the `suppress form feed at end of job' flag in the NetWare print entry. This instructs the print server not to 
  218. print a blank page at the end of the print job.
  219.  
  220.     Form Number:        
  221.         Will set the form number on print job entries.
  222.  
  223.     Printer Init:    
  224.         Enable the sending of data before each print job. This is used to set such options as font and orientation with 
  225. printer specific control codes. Selecting `file' indicates the initialisation information is held in a binary file that 
  226. you specify, selecting `string' indicates that you will directly specify the control characters. The latter is a more 
  227. efficient method.
  228.  
  229.     Enter Data:    
  230.         Select this to enter the init sequence data or filename. File names must include the NetWare volume name, e.g. 
  231. sys:\etc\hpinit
  232.         Strings are typed directly, control characters are enter